home *** CD-ROM | disk | FTP | other *** search
/ Video Toaster 4.2 / Video Toaster v4.2.iso / programs / documentation / lightwave / formatlwlo.txt next >
Text File  |  1995-10-05  |  3KB  |  63 lines
  1.                LIGHTWAVE 3D LAYERED OBJECT FILE FORMAT
  2.  
  3.                           by Stuart Ferguson
  4.                            revised  10/4/95
  5.  
  6.  
  7. Introduction
  8.  
  9.   The "Layered Object" LWLO file format is used by Modeler to save an
  10.   editing session which includes multiple layers of data, some active
  11.   and some in the background.  This IFF format file is nearly
  12.   identical to the normal LWOB format object file, so this document
  13.   assumes that the reader is familiar with the LWOB format.
  14.  
  15.   The IFF form-type is LWLO for "LightWave Layered Object" and it
  16.   contains the same PNTS, SRFS, POLS, CRVS and SURF chunks as LWOB
  17.   files.  Unlike the LWOB format, however, the LWLO file may contain
  18.   any number of PNTS, POLS and CRVS chunks, with each one describing
  19.   the contents of a single layer.  Layers are described by the LAYR
  20.   chunk.
  21.  
  22.  
  23. LAYR Chunk
  24.  
  25.   An LAYR chunk must precede each set of PNTS, POLS and CRVS data
  26.   chunks and indicates to which layer those data belong.  An LAYR
  27.   chunk consists of two unsigned short values and a string.  The first
  28.   is the layer number which should be from 1 to 10 to operate
  29.   correctly in Modeler.  This restriction may be lifted in future
  30.   versions of the format.  The second value is a bitfield where only
  31.   the lowest order bit is defined and all others should be zero.  This
  32.   bit is one if this is an active layer and zero if it is a background
  33.   layer.  The string which follows is the name of the layer and should
  34.   be null-terminated and padded to even length.
  35.  
  36.  
  37. Schematic Example
  38.  
  39.   The file is read just like any LWOB format file except that each time
  40.   a LAYR chunk is encountered, the subsequent PNTS, POLS and CRVS data
  41.   chunks are redirected to the indicated layer.  The SRFS and SURF
  42.   chunks are read normally.  Below is a simplified example which shows
  43.   a typical file and the order of reading.
  44.  
  45.     FORM LWLO       -- tag identifies file type and size
  46.         SRFS ...    -- surface name chunk gives name mappings
  47.                         for subsequent POLS chunks
  48.         LAYR        -- first layer starts
  49.             0003        layer 3 which is active and called "noname"
  50.             0001
  51.             6E 6F 6E 61 6D 65 00 00
  52.         PNTS ...    -- data in layer 3
  53.         POLS ...
  54.         LAYR        -- second layer starts
  55.             0006        layer 6, background, called "Foo"
  56.             0000
  57.             46 6F 6F 00
  58.         PNTS ...    -- data in layer 6
  59.         POLS ...
  60.         CRVS ...
  61.         SURF ...    -- surface description
  62.                     -- end implied by file length
  63.